NAME
	GU_AddTail -- Add a node to the end of a listview's list.

   SYNOPSIS
	node = GU_AddTail(gad, string, list)
	D0, SR (Z)        D0   A0      A1

	struct Node *GU_AddTail(struct Gadget *, STRPTR, struct List *);

   FUNCTION
	Add a node to the end of a list linked to a gadget (eg. a ListView).

	Normally this is used to add a node to a listview list, but it can
	also be used if you eg have another list that that contains
	information about the items in the listview. This list will then
	also be deallocated at the same time as the listview's own list.
	If you do this, be sure to clear the list header of this other list
	when you want to deallocate the list (you can use the GU_NewList
	function).

   INPUTS
	gad    - Gadget to keep the nodes in (ie the ListView gadget).

	string - String to put in the nodes' LN_NAME field (visible entry).

	list   - List to add the node to.

   RESULT
	node - Struct Node for success, FALSE for error.
	SR(Z)- 0 for success, 1 for error.

   NOTES
	The SR(Z) is probably most usable for assembly programmers.

   BUGS
	none known

   SEE ALSO
	GU_CountNodes(), GU_NewList(), GU_ClearList(), GU_DetachList(),
	GU_AttachList(), GU_FindNode(), GU_NodeUp(), GU_NodeDown(), GU_SortList()


[Main] [Previous] [Next]

Converted on 19 Jul 1996 with RexxDoesAmigaGuide2HTML by Michael Ranner.